home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1999 July: Mac OS SDK / Dev.CD Jul 99 SDK1.toast / Development Kits / Mac OS / QuickDraw3D 1.6 SDK / Mac Interfaces / AIncludes / RAVE.a < prev    next >
Encoding:
Text File  |  1999-05-18  |  47.0 KB  |  1,119 lines  |  [TEXT/MPS ]
  1. ;
  2. ;    File:        RAVE.a
  3. ;
  4. ;    Contains:    Interface for RAVE (Renderer Acceleration Virtual Engine)                            
  5. ;
  6. ;    Version:    Technology:    Quickdraw 3D 1.6
  7. ;                Release:    QuickTime 4.0
  8. ;
  9. ;    Copyright:    © 1995-1999 by Apple Computer, Inc., all rights reserved.
  10. ;
  11. ;    Bugs?:        For bug reports, consult the following page on
  12. ;                the World Wide Web:
  13. ;
  14. ;                    http://developer.apple.com/bugreporter/
  15. ;
  16. ;
  17.     IF &TYPE('__RAVE__') = 'UNDEFINED' THEN
  18. __RAVE__ SET 1
  19.  
  20.     IF &TYPE('__CONDITIONALMACROS__') = 'UNDEFINED' THEN
  21.     include 'ConditionalMacros.a'
  22.     ENDIF
  23.  
  24.     IF TARGET_OS_MAC THEN
  25.     IF &TYPE('__MACTYPES__') = 'UNDEFINED' THEN
  26.     include 'MacTypes.a'
  27.     ENDIF
  28.     IF &TYPE('__QUICKDRAW__') = 'UNDEFINED' THEN
  29.     include 'Quickdraw.a'
  30.     ENDIF
  31.     IF &TYPE('__QDOFFSCREEN__') = 'UNDEFINED' THEN
  32.     include 'QDOffscreen.a'
  33.     ENDIF
  34.  
  35.     ENDIF    ; TARGET_OS_MAC
  36.     IF TARGET_OS_WIN32 THEN
  37.     IF &TYPE('RAVE_NO_DIRECTDRAW') = 'UNDEFINED' THEN
  38.     ENDIF
  39.     ENDIF    ; TARGET_OS_WIN32
  40.     RAVE_OBSOLETE: SET 0
  41. ; ******************************************************************************
  42. ; *
  43. ; * Platform dependent datatypes: TQAImagePixelType, TQADevice, TQAClip, and TQARect.
  44. ; *
  45. ; ****************************************************************************
  46.  
  47.  
  48. ; typedef long                            TQAImagePixelType
  49. kQAPixel_Alpha1                    EQU        0                    ; 1 bit/pixel alpha 
  50. kQAPixel_RGB16                    EQU        1                    ; 16 bits/pixel, R=14:10, G=9:5, B=4:0 
  51. kQAPixel_ARGB16                    EQU        2                    ; 16 bits/pixel, A=15, R=14:10, G=9:5, B=4:0 
  52. kQAPixel_RGB32                    EQU        3                    ; 32 bits/pixel, R=23:16, G=15:8, B=7:0 
  53. kQAPixel_ARGB32                    EQU        4                    ; 32 bits/pixel, A=31:24, R=23:16, G=15:8, B=7:0 
  54. kQAPixel_CL4                    EQU        5                    ; 4 bit color look up table, always big endian, ie high 4 bits effect left pixel 
  55. kQAPixel_CL8                    EQU        6                    ; 8 bit color look up table 
  56. kQAPixel_RGB16_565                EQU        7                    ; Win32 ONLY  16 bits/pixel, no alpha, R:5, G:6, B:5 
  57. kQAPixel_RGB24                    EQU        8                    ; Win32 ONLY  24 bits/pixel, no alpha, R:8, G:8, B:8 
  58. kQAPixel_RGB8_332                EQU        9                    ; 8 bits/pixel, R=7:5, G = 4:2, B = 1:0 
  59. kQAPixel_ARGB16_4444            EQU        10                    ; 16 bits/pixel, A=15:12, R=11:8, G=7:4, B=3:0 
  60. kQAPixel_ACL16_88                EQU        11                    ; 16 bits/pixel, A=15:8, CL=7:0, 8 bit alpha + 8 bit color lookup 
  61. kQAPixel_I8                        EQU        12                    ; 8 bits/pixel, I=7:0, intensity map (grayscale) 
  62. kQAPixel_AI16_88                EQU        13                    ; 16 bits/pixel, A=15:8, I=7:0, intensity map (grayscale) 
  63. kQAPixel_YUVS                    EQU        14                    ; 16 bits/pixel, QD's kYUVSPixelFormat (4:2:2, YUYV ordering, unsigned UV) 
  64. kQAPixel_YUVU                    EQU        15                    ; 16 bits/pixel, QD's kYUVUPixelFormat (4:2:2, YUYV ordering, signed UV) 
  65. kQAPixel_YVYU422                EQU        16                    ; 16 bits/pixel, QD's kYVYU422PixelFormat (4:2:2, YVYU ordering, unsigned UV) 
  66. kQAPixel_UYVY422                EQU        17                    ; 16 bits/pixel, QD's kUYVY422PixelFormat (4:2:2, UYVY ordering, unsigned UV) 
  67.  
  68. ; typedef long                            TQAColorTableType
  69. kQAColorTable_CL8_RGB32            EQU        0                    ; 256 entry, 32 bit/pixel, R=23:16, G=15:8, B=7:0 
  70. kQAColorTable_CL4_RGB32            EQU        1                    ; 16 entry, 32 bit/pixel, R=23:16, G=15:8, B=7:0 
  71. ;  Selects target device type 
  72.  
  73. ; typedef long                            TQADeviceType
  74. kQADeviceMemory                    EQU        0                    ; Memory draw context 
  75. kQADeviceGDevice                EQU        1                    ; Macintosh GDevice draw context 
  76. kQADeviceWin32DC                EQU        2                    ; Win32 DC 
  77. kQADeviceDDSurface                EQU        3                    ; Win32 DirectDraw Surface 
  78. ;  Generic memory pixmap device 
  79. TQADeviceMemory            RECORD 0
  80. rowBytes                 ds.l    1                ; offset: $0 (0)        ;  Rowbytes 
  81. pixelType                 ds.l    1                ; offset: $4 (4)        ;  Depth, color space, etc. 
  82. width                     ds.l    1                ; offset: $8 (8)        ;  Width in pixels 
  83. height                     ds.l    1                ; offset: $C (12)        ;  Height in pixels 
  84. baseAddr                 ds.l    1                ; offset: $10 (16)        ;  Base address of pixmap 
  85. sizeof                     EQU *                    ; size:   $14 (20)
  86.                         ENDR
  87. ;  Offscreen Device 
  88. TQADeviceOffscreen        RECORD 0
  89. pixelType                 ds.l    1                ; offset: $0 (0)        ;  Depth, color space, etc. 
  90. sizeof                     EQU *                    ; size:   $4 (4)
  91.                         ENDR
  92. ;  Selects target clip type 
  93.  
  94. ; typedef long                            TQAClipType
  95. kQAClipRgn                        EQU        0                    ; Macintosh clipRgn with serial number 
  96. kQAClipWin32Rgn                    EQU        1                    ; Win32 clip region 
  97. TQARect                    RECORD 0
  98. left                     ds.l    1                ; offset: $0 (0)
  99. right                     ds.l    1                ; offset: $4 (4)
  100. top                         ds.l    1                ; offset: $8 (8)
  101. bottom                     ds.l    1                ; offset: $C (12)
  102. sizeof                     EQU *                    ; size:   $10 (16)
  103.                         ENDR
  104.     IF TARGET_OS_MAC THEN
  105. TQAPlatformDevice        RECORD 0
  106. memoryDevice             ds        TQADeviceMemory ; offset: $0 (0)
  107.                          ORG 0
  108. gDevice                     ds.l    1                ; offset: $0 (0)
  109.                          ORG 20
  110. sizeof                     EQU *                    ; size:   $14 (20)
  111.                         ENDR
  112. TQAPlatformClip            RECORD 0
  113. clipRgn                     ds.l    1                ; offset: $0 (0)
  114. sizeof                     EQU *                    ; size:   $4 (4)
  115.                         ENDR
  116. ; typedef long                             TQADrawNotificationProcRefNum
  117.  
  118. ;  used to unregister your proc 
  119.     ELSEIF TARGET_OS_WIN32 THEN
  120.     ELSE
  121. ; 
  122. ;     * Generic platform supports memory device only. TQARect is generic. TQAClip is ???.
  123. ;     
  124.  
  125. TQAPlatformDevice        RECORD 0
  126. memoryDevice             ds        TQADeviceMemory ; offset: $0 (0)
  127. sizeof                     EQU *                    ; size:   $14 (20)
  128.                         ENDR
  129. TQAPlatformClip            RECORD 0
  130. region                     ds.l    1                ; offset: $0 (0)        ;  ??? 
  131. sizeof                     EQU *                    ; size:   $4 (4)
  132.                         ENDR
  133.     ENDIF    ; 
  134. TQADevice                RECORD 0
  135. deviceType                 ds.l    1                ; offset: $0 (0)
  136. device                     ds        TQAPlatformDevice ; offset: $4 (4)
  137. sizeof                     EQU *                    ; size:   $18 (24)
  138.                         ENDR
  139. TQAClip                    RECORD 0
  140. clipType                 ds.l    1                ; offset: $0 (0)
  141. clip                     ds        TQAPlatformClip ; offset: $4 (4)
  142. sizeof                     EQU *                    ; size:   $8 (8)
  143.                         ENDR
  144. ; ******************************************************************************
  145. ; *
  146. ; * Basic data types.
  147. ; *
  148. ; ****************************************************************************
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171. ;  A single triangle element for QADrawTriMesh 
  172. TQAIndexedTriangle        RECORD 0
  173. triangleFlags             ds.l    1                ; offset: $0 (0)        ;  Triangle flags, see kQATriFlags_ 
  174. vertices                 ds.l    3                ; offset: $4 (4)        ;  Indices into a vertex array 
  175. sizeof                     EQU *                    ; size:   $10 (16)
  176.                         ENDR
  177. ;  An image for use as texture or bitmap 
  178. TQAImage                RECORD 0
  179. width                     ds.l    1                ; offset: $0 (0)        ;  Width of pixmap 
  180. height                     ds.l    1                ; offset: $4 (4)        ;  Height of pixmap 
  181. rowBytes                 ds.l    1                ; offset: $8 (8)        ;  Rowbytes of pixmap 
  182. pixmap                     ds.l    1                ; offset: $C (12)        ;  Pixmap 
  183. sizeof                     EQU *                    ; size:   $10 (16)
  184.                         ENDR
  185. ;  a pixel buffer 
  186. TQAPixelBuffer            RECORD 0
  187. f                         ds        TQADeviceMemory
  188. sizeof                     EQU *                    ; size:   $14 (20)
  189.                         ENDR
  190.  
  191.  
  192. ;  a zbuffer 
  193. TQAZBuffer                RECORD 0
  194. width                     ds.l    1                ; offset: $0 (0)        ;  Width of pixmap 
  195. height                     ds.l    1                ; offset: $4 (4)        ;  Height of pixmap 
  196. rowBytes                 ds.l    1                ; offset: $8 (8)        ;  Rowbytes of pixmap 
  197. zbuffer                     ds.l    1                ; offset: $C (12)        ;  pointer to the zbuffer data 
  198. zDepth                     ds.l    1                ; offset: $10 (16)        ;  bit depth of zbuffer (16,24,32...) 
  199. isBigEndian                 ds.l    1                ; offset: $14 (20)        ;  true if zbuffer values are in big-endian format, false if little-endian 
  200. sizeof                     EQU *                    ; size:   $18 (24)
  201.                         ENDR
  202. ;  Standard error type 
  203.  
  204. ; typedef long                            TQAError
  205. kQANoErr                        EQU        0                    ; No error 
  206. kQAError                        EQU        1                    ; Generic error flag 
  207. kQAOutOfMemory                    EQU        2                    ; Insufficient memory 
  208. kQANotSupported                    EQU        3                    ; Requested feature is not supported 
  209. kQAOutOfDate                    EQU        4                    ; A newer drawing engine was registered 
  210. kQAParamErr                        EQU        5                    ; Error in passed parameters 
  211. kQAGestaltUnknown                EQU        6                    ; Requested gestalt type isn't available 
  212. kQADisplayModeUnsupported        EQU        7                    ; Engine cannot render to the display in its current , 
  213.                                                             ; mode, but could if it were in some other mode 
  214. kQAOutOfVideoMemory                EQU        8                    ; There is not enough VRAM to support the desired context dimensions 
  215. ;  TQABoolean 
  216. ; typedef unsigned char                 TQABoolean
  217.  
  218. ; ************************************************************************************************
  219. ; *
  220. ; * Vertex data types.
  221. ; *
  222. ; **********************************************************************************************
  223.  
  224. ; 
  225. ; * TQAVGouraud is used for Gouraud shading. Each vertex specifies position, color and Z.
  226. ; *
  227. ; * Alpha is always treated as indicating transparency. Drawing engines which don't
  228. ; * support Z-sorted rendering use the back-to-front transparency blending functions
  229. ; * shown below. (ARGBsrc are the source (new) values, ARGBdest are  the destination
  230. ; * (previous) pixel values.)
  231. ; *
  232. ; *        Premultiplied                            Interpolated
  233. ; *
  234. ; *        A = 1 - (1 - Asrc) * (1 - Adest)        A = 1 - (1 - Asrc) * (1 - Adest) 
  235. ; *        R = (1 - Asrc) * Rdest + Rsrc            R = (1 - Asrc) * Rdest + Asrc * Rsrc
  236. ; *        G = (1 - Asrc) * Gdest + Gsrc            G = (1 - Asrc) * Gdest + Asrc * Gsrc
  237. ; *        B = (1 - Asrc) * Bdest + Bsrc            B = (1 - Asrc) * Bdest + Asrc * Bsrc
  238. ; *
  239. ; * Note that the use of other blending modes to implement antialiasing is performed
  240. ; * automatically by the drawing engine when the kQATag_Antialias variable !=
  241. ; * kQAAntiAlias_Fast. The driving software should continue to use the alpha fields
  242. ; * for transparency even when antialiasing is being used (the drawing engine will
  243. ; * resolve the multiple blending requirements as best as it can).
  244. ; *
  245. ; * Drawing engines which perform front-to-back Z-sorted rendering should replace
  246. ; * the blending function shown above with the equivalent front-to-back formula.
  247. ; 
  248.  
  249. TQAVGouraud                RECORD 0
  250. x                         ds        Float32            ; offset: $0 (0)        ;  X pixel coordinate, 0.0 <= x < width 
  251. y                         ds        Float32            ; offset: $4 (4)        ;  Y pixel coordinate, 0.0 <= y < height 
  252. z                         ds        Float32            ; offset: $8 (8)        ;  Z coordinate, 0.0 <= z <= 1.0 
  253. invW                     ds        Float32            ; offset: $C (12)        ;  1 / w; required only when kQAPerspectiveZ_On is set 
  254. r                         ds        Float32            ; offset: $10 (16)        ;  Red, 0.0 <= r <= 1.0 
  255. g                         ds        Float32            ; offset: $14 (20)        ;  Green, 0.0 <= g <= 1.0 
  256. b                         ds        Float32            ; offset: $18 (24)        ;  Blue, 0.0 <= b <= 1.0 
  257. a                         ds        Float32            ; offset: $1C (28)        ;  Alpha, 0.0 <= a <= 1.0, 1.0 is opaque 
  258. sizeof                     EQU *                    ; size:   $20 (32)
  259.                         ENDR
  260. ; 
  261. ; * TQAVTexture is used for texture mapping. The texture mapping operation
  262. ; * is controlled by the kQATag_TextureOp variable, which is a mask of
  263. ; * kQATextureOp_None/Modulate/Highlight/Decal. Below is pseudo-code for the
  264. ; * texture shading operation:
  265. ; *
  266. ; *        texPix = TextureLookup (uq/q, vq/q);
  267. ; *        if (kQATextureOp_Decal)
  268. ; *        {
  269. ; *            texPix.r = texPix.a * texPix.r + (1 - texPix.a) * r;
  270. ; *            texPix.g = texPix.a * texPix.g + (1 - texPix.a) * g;
  271. ; *            texPix.b = texPix.a * texPix.b + (1 - texPix.a) * b;
  272. ; *            texPix.a = a;
  273. ; *        }
  274. ; *        else
  275. ; *        {
  276. ; *            texPix.a = texPix.a * a;
  277. ; *        }
  278. ; *        if (kQATextureOp_Modulate)
  279. ; *        {
  280. ; *            texPix.r *= kd_r;        // Clamped to prevent overflow
  281. ; *            texPix.g *= kd_g;        // Clamped to prevent overflow
  282. ; *            texPix.b *= kd_b;        // Clamped to prevent overflow
  283. ; *        }
  284. ; *        if (kQATextureOp_Highlight)
  285. ; *        {
  286. ; *            texPix.r += ks_r;        // Clamped to prevent overflow
  287. ; *            texPix.g += ks_g;        // Clamped to prevent overflow
  288. ; *            texPix.b += ks_b;        // Clamped to prevent overflow
  289. ; *        }
  290. ; *
  291. ; * After computation of texPix, transparency blending (as shown
  292. ; * above for TQAVGouraud) is performed.
  293. ; 
  294.  
  295. TQAVTexture                RECORD 0
  296. x                         ds        Float32            ; offset: $0 (0)        ;  X pixel coordinate, 0.0 <= x < width 
  297. y                         ds        Float32            ; offset: $4 (4)        ;  Y pixel coordinate, 0.0 <= y < height 
  298. z                         ds        Float32            ; offset: $8 (8)        ;  Z coordinate, 0.0 <= z <= 1.0 
  299. invW                     ds        Float32            ; offset: $C (12)        ;  1 / w (always required) 
  300. ;  rgb are used only when kQATextureOp_Decal is set. a is always required 
  301. r                         ds        Float32            ; offset: $10 (16)        ;  Red, 0.0 <= r <= 1.0 
  302. g                         ds        Float32            ; offset: $14 (20)        ;  Green, 0.0 <= g <= 1.0 
  303. b                         ds        Float32            ; offset: $18 (24)        ;  Blue, 0.0 <= b <= 1.0 
  304. a                         ds        Float32            ; offset: $1C (28)        ;  Alpha, 0.0 <= a <= 1.0, 1.0 is opaque 
  305. ;  uOverW and vOverW are required by all modes 
  306. uOverW                     ds        Float32            ; offset: $20 (32)        ;  u / w 
  307. vOverW                     ds        Float32            ; offset: $24 (36)        ;  v / w 
  308. ;  kd_r/g/b are used only when kQATextureOp_Modulate is set 
  309. kd_r                     ds        Float32            ; offset: $28 (40)        ;  Scale factor for texture red, 0.0 <= kd_r 
  310. kd_g                     ds        Float32            ; offset: $2C (44)        ;  Scale factor for texture green, 0.0 <= kd_g 
  311. kd_b                     ds        Float32            ; offset: $30 (48)        ;  Scale factor for texture blue, 0.0 <= kd_b 
  312. ;  ks_r/g/b are used only when kQATextureOp_Highlight is set 
  313. ks_r                     ds        Float32            ; offset: $34 (52)        ;  Red specular highlight, 0.0 <= ks_r <= 1.0 
  314. ks_g                     ds        Float32            ; offset: $38 (56)        ;  Green specular highlight, 0.0 <= ks_g <= 1.0 
  315. ks_b                     ds        Float32            ; offset: $3C (60)        ;  Blue specular highlight, 0.0 <= ks_b <= 1.0 
  316. sizeof                     EQU *                    ; size:   $40 (64)
  317.                         ENDR
  318. ; 
  319. ;*  TQAVMultiTexture allows you to specify the uv and invW values
  320. ;*  for secondary textures.  This data is submitted with the
  321. ;*  QASubmitMultiTextureParams() call.
  322. ;
  323.  
  324. TQAVMultiTexture        RECORD 0
  325. invW                     ds        Float32            ; offset: $0 (0)
  326. uOverW                     ds        Float32            ; offset: $4 (4)
  327. vOverW                     ds        Float32            ; offset: $8 (8)
  328. sizeof                     EQU *                    ; size:   $C (12)
  329.                         ENDR
  330.  
  331. ; ************************************************************************************************
  332. ; *
  333. ; * Constants used for the state variables.
  334. ; *
  335. ; **********************************************************************************************
  336.  
  337. ; 
  338. ; * kQATag_xxx is used to select a state variable when calling QASetFloat(), QASetInt(),
  339. ; * QAGetFloat() and QAGetInt(). The kQATag values are split into three separate enumerated
  340. ; * types: TQATagInt, TQATagPtr and TQATagFloat. TQATagInt is used for the QASet/GetInt()
  341. ; * functions, TQATagPtr is used for the QASet/GetPtr() functions, and TQATagFloat is used for 
  342. ; * the QASet/GetFloat() functions. (This is so that a compiler that typechecks enums can flag
  343. ; * a float/int tag mismatch during compile.)
  344. ; *
  345. ; * -=- All tag values must be unique even across all three types. -=-
  346. ; *
  347. ; * These variables are required by all drawing engines:
  348. ; *        kQATag_ZFunction            (Int)    One of kQAZFunction_xxx
  349. ; *        kQATag_ColorBG_a            (Float)    Background color alpha
  350. ; *        kQATag_ColorBG_r            (Float)    Background color red
  351. ; *        kQATag_ColorBG_g            (Float)    Background color green
  352. ; *        kQATag_ColorBG_b            (Float)    Background color blue
  353. ; *        kQATag_Width                (Float)    Line and point width (pixels)
  354. ; *        kQATag_ZMinOffset            (Float)    Min offset to Z to guarantee visibility (Read only!)
  355. ; *        kQATag_ZMinScale            (Float)    Min scale to Z to guarantee visibility (Read only!)
  356. ; 
  357. ; * These variables are used for optional features:
  358. ; *        kQATag_Antialias            (Int)    One of kQAAntiAlias_xxx
  359. ; *        kQATag_Blend                (Int)    One of kQABlend_xxx
  360. ; *        kQATag_PerspectiveZ            (Int)    One of kQAPerspectiveZ_xxx
  361. ; *        kQATag_TextureFilter        (Int)    One of kQATextureFilter_xxx
  362. ; *        kQATag_TextureOp            (Int)    Mask of kQATextureOp_xxx
  363. ; *        kQATag_Texture                (Ptr)    Pointer to current TQATexture
  364. ; *        kQATag_CSGTag                (Int)    One of kQACSGTag_xxx
  365. ; *        kQATag_CSGEquation            (Int)    32 bit CSG truth table
  366. ; *        kQATag_FogMode                (Int)   One of kQAFogMode_xxxx
  367. ; *        kQATag_FogColor_a            (Float) Fog color alpha
  368. ; *        kQATag_FogColor_r            (Float) Fog color red
  369. ; *        kQATag_FogColor_g            (Float) Fog color green
  370. ; *        kQATag_FogColor_b            (Float) Fog color blue
  371. ; *        kQATag_FogStart                (Float) Fog start
  372. ; *        kQATag_FogEnd                (Float) Fog end
  373. ; *        kQATag_FogDensity            (Float) Fog density
  374. ; *        kQATag_FogMaxDepth            (Float) Maximun value for 1.0 / invW
  375. ; *        kQATag_MipmapBias             (Float) The mipmap page bias factor
  376. ; *        kQATag_ChannelMask            (Int) one of kQAChannelMask_xxx
  377. ; *        kQATag_ZBufferMask            (Int) one of kQAZBufferMask_xxx
  378. ; *        kQATag_ZSortedHint            (Int) 1 = depth sort transparent triangles, 0 = do not sort.
  379. ; *        kQATag_Chromakey_r            (Float) chroma key red
  380. ; *        kQATag_Chromakey_g            (Float) chroma key green
  381. ; *        kQATag_Chromakey_b            (Float) chroma key blue
  382. ; *        kQATag_ChromakeyEnable        (Int) 1 = enable chroma keying, 0 = disable chroma keying
  383. ; *        kQATag_AlphaTestFunc        (Int) one of kQAAlphaTest_xxx
  384. ; *        kQATag_AlphaTestRef            (Float) from 0 to 1
  385. ; *        kQATag_DontSwap                (Int) 1 = dont swap buffers during QARenderEnd, 0 = do swap buffers during QARenderEnd.
  386. ;
  387. ; *      kQATag_MultiTextureOp       (Int) One of kQAMultiTexture_xxx
  388. ; *        kQATag_MultiTextureFilter   (Int) One of kQATextureFilter_xxx
  389. ; *        kQATag_MultiTextureCurrent    (Int) which multitexture layer to use for all other multitexture funcs
  390. ; *        kQATag_MultiTextureEnable    (Int) how many multitexture layers to use (0 = no multitexturing).
  391. ; *        kQATag_MultiTextureWrapU    (Int)
  392. ; *        kQATag_MultiTextureWrapV    (Int)
  393. ; *        kQATag_MultiTextureMagFilter (Int)
  394. ; *        kQATag_MultiTextureMinFilter (Int)
  395. ; *        kQATag_MultiTextureBorder_a    (Float)
  396. ; *        kQATag_MultiTextureBorder_r    (Float)
  397. ; *        kQATag_MultiTextureBorder_g    (Float)
  398. ; *        kQATag_MultiTextureBorder_b    (Float)
  399. ; *        kQATag_MultiTextureMipmapBias (Float)
  400. ; *        kQATag_MultiTextureFactor     (Float) used with kQAMultiTexture_Fixed to determine blending factor
  401. ; *
  402. ; * These variables are used for OpenGL™ support:
  403. ; *        kQATagGL_DrawBuffer            (Int)    Mask of kQAGL_DrawBuffer_xxx
  404. ; *        kQATagGL_TextureWrapU        (Int)    kQAGL_Clamp or kQAGL_Repeat
  405. ; *        kQATagGL_TextureWrapV        (Int)    kQAGL_Clamp or kQAGL_Repeat
  406. ; *        kQATagGL_TextureMagFilter    (Int)    kQAGL_Nearest or kQAGL_Linear
  407. ; *        kQATagGL_TextureMinFilter    (Int)    kQAGL_Nearest, etc.
  408. ; *        kQATagGL_ScissorXMin        (Int)    Minimum X value for scissor rectangle
  409. ; *        kQATagGL_ScissorYMin        (Int)    Minimum Y value for scissor rectangle
  410. ; *        kQATagGL_ScissorXMax        (Int)    Maximum X value for scissor rectangle
  411. ; *        kQATagGL_ScissorYMax        (Int)    Maximum Y value for scissor rectangle
  412. ; *        kQATagGL_BlendSrc            (Int)    Source blending operation
  413. ; *        kQATagGL_BlendDst            (Int)    Destination blending operation
  414. ; *        kQATagGL_LinePattern        (Int)    Line rasterization pattern
  415. ; *        kQATagGL_AreaPattern0        (Int)    First of 32 area pattern registers
  416. ; *        kQATagGL_AreaPattern31        (Int)    Last of 32 area pattern registers
  417. ; *
  418. ; *        kQATagGL_DepthBG            (Float)    Background Z
  419. ; *        kQATagGL_TextureBorder_a    (Float)    Texture border color alpha
  420. ; *        kQATagGL_TextureBorder_r    (Float)    Texture border color red
  421. ; *        kQATagGL_TextureBorder_g    (Float)    Texture border color green
  422. ; *        kQATagGL_TextureBorder_b    (Float)    Texture border color blue
  423. ; *
  424. ; * Tags >= kQATag_EngineSpecific_Minimum may be assigned by the vendor for use as
  425. ; * engine-specific variables. NOTE: These should be used only in exceptional circumstances,
  426. ; * as functions performed by these variables won't be generally accessible. All other tag
  427. ; * values are reserved.
  428. ; *
  429. ; *        kQATag_EngineSpecific_Minimum    Minimum tag value for drawing-engine specific variables
  430. ; 
  431.  
  432.  
  433. ; typedef long                            TQATagInt
  434. kQATag_ZFunction                EQU        0
  435. kQATag_Antialias                EQU        8
  436. kQATag_Blend                    EQU        9
  437. kQATag_PerspectiveZ                EQU        10
  438. kQATag_TextureFilter            EQU        11
  439. kQATag_TextureOp                EQU        12
  440. kQATag_CSGTag                    EQU        14
  441. kQATag_CSGEquation                EQU        15
  442. kQATag_BufferComposite            EQU        16
  443. kQATag_FogMode                    EQU        17
  444. kQATag_ChannelMask                EQU        27
  445. kQATag_ZBufferMask                EQU        28
  446. kQATag_ZSortedHint                EQU        29
  447. kQATag_ChromakeyEnable            EQU        30
  448. kQATag_AlphaTestFunc            EQU        31
  449. kQATag_DontSwap                    EQU        32
  450. kQATag_MultiTextureEnable        EQU        33
  451. kQATag_MultiTextureCurrent        EQU        34
  452. kQATag_MultiTextureOp            EQU        35
  453. kQATag_MultiTextureFilter        EQU        36
  454. kQATag_MultiTextureWrapU        EQU        37
  455. kQATag_MultiTextureWrapV        EQU        38
  456. kQATag_MultiTextureMagFilter    EQU        39
  457. kQATag_MultiTextureMinFilter    EQU        40
  458. kQATag_BitmapFilter                EQU        54                    ; filter to use while scaling bitmaps, one of kQAFilter_xxx 
  459. kQATag_DrawContextFilter        EQU        55                    ; filter to use while scaling draw contexts, one of kQAFilter_xxx 
  460. kQATagGL_DrawBuffer                EQU        100
  461. kQATagGL_TextureWrapU            EQU        101
  462. kQATagGL_TextureWrapV            EQU        102
  463. kQATagGL_TextureMagFilter        EQU        103
  464. kQATagGL_TextureMinFilter        EQU        104
  465. kQATagGL_ScissorXMin            EQU        105
  466. kQATagGL_ScissorYMin            EQU        106
  467. kQATagGL_ScissorXMax            EQU        107
  468. kQATagGL_ScissorYMax            EQU        108
  469. kQATagGL_BlendSrc                EQU        109
  470. kQATagGL_BlendDst                EQU        110
  471. kQATagGL_LinePattern            EQU        111
  472. kQATagGL_AreaPattern0            EQU        117                    ; ...kQATagGL_AreaPattern1-30 
  473. kQATagGL_AreaPattern31            EQU        148
  474. kQATagGL_LinePatternFactor        EQU        149                    ; equivalent to GL_LINE_STIPPLE_REPEAT 
  475. kQATag_EngineSpecific_Minimum    EQU        1000
  476.  
  477. ; typedef long                            TQATagPtr
  478. kQATag_Texture                    EQU        13
  479. kQATag_MultiTexture                EQU        26
  480.  
  481. ; typedef long                            TQATagFloat
  482. kQATag_ColorBG_a                EQU        1
  483. kQATag_ColorBG_r                EQU        2
  484. kQATag_ColorBG_g                EQU        3
  485. kQATag_ColorBG_b                EQU        4
  486. kQATag_Width                    EQU        5
  487. kQATag_ZMinOffset                EQU        6
  488. kQATag_ZMinScale                EQU        7
  489. kQATag_FogColor_a                EQU        18
  490. kQATag_FogColor_r                EQU        19
  491. kQATag_FogColor_g                EQU        20
  492. kQATag_FogColor_b                EQU        21
  493. kQATag_FogStart                    EQU        22
  494. kQATag_FogEnd                    EQU        23
  495. kQATag_FogDensity                EQU        24
  496. kQATag_FogMaxDepth                EQU        25
  497. kQATag_MipmapBias                EQU        41
  498. kQATag_MultiTextureMipmapBias    EQU        42
  499. kQATag_Chromakey_r                EQU        43
  500. kQATag_Chromakey_g                EQU        44
  501. kQATag_Chromakey_b                EQU        45
  502. kQATag_AlphaTestRef                EQU        46
  503. kQATag_MultiTextureBorder_a        EQU        47
  504. kQATag_MultiTextureBorder_r        EQU        48
  505. kQATag_MultiTextureBorder_g        EQU        49
  506. kQATag_MultiTextureBorder_b        EQU        50
  507. kQATag_MultiTextureFactor        EQU        51
  508. kQATag_BitmapScale_x            EQU        52                    ; horizontal bitmap scale factor, default value is 1.0 
  509. kQATag_BitmapScale_y            EQU        53                    ; vertical bitmap scale factor, default value is 1.0 
  510. kQATag_MultiTextureEnvColor_a    EQU        56
  511. kQATag_MultiTextureEnvColor_r    EQU        57
  512. kQATag_MultiTextureEnvColor_g    EQU        58
  513. kQATag_MultiTextureEnvColor_b    EQU        59
  514. kQATagGL_DepthBG                EQU        112
  515. kQATagGL_TextureBorder_a        EQU        113
  516. kQATagGL_TextureBorder_r        EQU        114
  517. kQATagGL_TextureBorder_g        EQU        115
  518. kQATagGL_TextureBorder_b        EQU        116
  519. kQATagGL_TextureEnvColor_a        EQU        150
  520. kQATagGL_TextureEnvColor_r        EQU        151
  521. kQATagGL_TextureEnvColor_g        EQU        152
  522. kQATagGL_TextureEnvColor_b        EQU        153
  523.  
  524. ;  kQATag_ZFunction 
  525.  
  526. kQAZFunction_None                EQU        0                    ; Z is neither tested nor written (same as no Z buffer) 
  527. kQAZFunction_LT                    EQU        1                    ; Znew < Zbuffer is visible 
  528. kQAZFunction_EQ                    EQU        2                    ; Znew == Zbuffer is visible 
  529. kQAZFunction_LE                    EQU        3                    ; Znew <= Zbuffer is visible 
  530. kQAZFunction_GT                    EQU        4                    ; Znew > Zbuffer is visible 
  531. kQAZFunction_NE                    EQU        5                    ; Znew != Zbuffer is visible 
  532. kQAZFunction_GE                    EQU        6                    ; Znew >= Zbuffer is visible 
  533. kQAZFunction_True                EQU        7                    ; Znew is always visible 
  534. kQAZFunction_False                EQU        8                    ; Znew is never visible 
  535. ;  kQATag_Width 
  536. ;  kQATag_Antialias 
  537.  
  538. kQAAntiAlias_Off                EQU        0
  539. kQAAntiAlias_Fast                EQU        1
  540. kQAAntiAlias_Mid                EQU        2
  541. kQAAntiAlias_Best                EQU        3
  542. ;  kQATag_Blend 
  543.  
  544. kQABlend_PreMultiply            EQU        0
  545. kQABlend_Interpolate            EQU        1
  546. kQABlend_OpenGL                    EQU        2
  547. ;  kQATag_BufferComposite 
  548.  
  549. kQABufferComposite_None            EQU        0                    ; Default: New pixels overwrite initial buffer contents 
  550. kQABufferComposite_PreMultiply    EQU        1                    ; New pixels are blended with initial buffer contents via PreMultiply 
  551. kQABufferComposite_Interpolate    EQU        2                    ; New pixels are blended with initial buffer contents via Interpolate 
  552. ;  kQATag_PerspectiveZ 
  553.  
  554. kQAPerspectiveZ_Off                EQU        0                    ; Use Z for hidden surface removal 
  555. kQAPerspectiveZ_On                EQU        1                    ; Use InvW for hidden surface removal 
  556. ;  kQATag_TextureFilter 
  557.  
  558.                                                             ; suggested meanings of these values 
  559. kQATextureFilter_Fast            EQU        0                    ; No filtering, pick nearest 
  560. kQATextureFilter_Mid            EQU        1                    ; Fastest method that does some filtering 
  561. kQATextureFilter_Best            EQU        2                    ; Highest quality renderer can do 
  562. ;  filter tag values 
  563.  
  564.                                                             ; suggested meanings of these values 
  565. kQAFilter_Fast                    EQU        0                    ; No filtering, pick nearest 
  566. kQAFilter_Mid                    EQU        1                    ; Fastest method that does some filtering 
  567. kQAFilter_Best                    EQU        2                    ; Highest quality renderer can do 
  568. ;  kQATag_TextureOp (mask of one or more) 
  569.  
  570. kQATextureOp_None                EQU        0                    ; Default texture mapping mode 
  571. kQATextureOp_Modulate            EQU        $01                    ; Modulate texture color with kd_r/g/b 
  572. kQATextureOp_Highlight            EQU        $02                    ; Add highlight value ks_r/g/b 
  573. kQATextureOp_Decal                EQU        $04                    ; When texture alpha == 0, use rgb instead 
  574. kQATextureOp_Shrink                EQU        $08                    ; This is a non-wrapping texture, so the ??? 
  575. kQATextureOp_Blend                EQU        $10                    ; Same as GL_TEXTURE_ENV_MODE GL_BLEND 
  576. ;  kQATag_MultiTextureOp 
  577.  
  578. kQAMultiTexture_Add                EQU        0                    ; texels are added to form final pixel 
  579. kQAMultiTexture_Modulate        EQU        1                    ; texels are multiplied to form final pixel 
  580. kQAMultiTexture_BlendAlpha        EQU        2                    ; texels are blended according to 2nd texel's alpha 
  581. kQAMultiTexture_Fixed            EQU        3                    ; texels are blended by a fixed factor via kQATag_MultiTextureFactor  
  582. ;  kQATag_CSGTag 
  583.  
  584. kQACSGTag_0                        EQU        0                    ; Submitted tris have CSG ID 0 
  585. kQACSGTag_1                        EQU        1                    ; Submitted tris have CSG ID 1 
  586. kQACSGTag_2                        EQU        2                    ; Submitted tris have CSG ID 2 
  587. kQACSGTag_3                        EQU        3                    ; Submitted tris have CSG ID 3 
  588. kQACSGTag_4                        EQU        4                    ; Submitted tris have CSG ID 4 
  589. ;  kQATagGL_TextureWrapU/V 
  590.  
  591. kQAGL_Repeat                    EQU        0
  592. kQAGL_Clamp                        EQU        1
  593. ;  kQATagGL_BlendSrc 
  594.  
  595. kQAGL_SourceBlend_XXX            EQU        0
  596. ;  kQATagGL_BlendDst 
  597.  
  598. kQAGL_DestBlend_XXX                EQU        0
  599. ;  kQATagGL_DrawBuffer (mask of one or more) 
  600.  
  601. kQAGL_DrawBuffer_None            EQU        0
  602. kQAGL_DrawBuffer_FrontLeft        EQU        $01
  603. kQAGL_DrawBuffer_FrontRight        EQU        $02
  604. kQAGL_DrawBuffer_BackLeft        EQU        $04
  605. kQAGL_DrawBuffer_BackRight        EQU        $08
  606. kQAGL_DrawBuffer_Front            EQU        $03
  607. kQAGL_DrawBuffer_Back            EQU        $0C
  608. ;  kQATag_FogMode 
  609.  
  610. kQAFogMode_None                    EQU        0                    ; no fog                                    
  611. kQAFogMode_Alpha                EQU        1                    ; fog value is alpha                        
  612. kQAFogMode_Linear                EQU        2                    ; fog = (end - z) / (end - start)            
  613. kQAFogMode_Exponential            EQU        3                    ; fog = exp(-density * z)                    
  614. kQAFogMode_ExponentialSquared    EQU        4                    ; fog = exp(-density * z * density * z)    
  615.  
  616. ;  kQATag_ChannelMask 
  617.  
  618. kQAChannelMask_r                EQU        $01
  619. kQAChannelMask_g                EQU        $02
  620. kQAChannelMask_b                EQU        $04
  621. kQAChannelMask_a                EQU        $08
  622.  
  623. ;  kQATag_ZBufferMask 
  624.  
  625. kQAZBufferMask_Disable            EQU        0
  626. kQAZBufferMask_Enable            EQU        1
  627. ;  kQATag_AlphaTestFunc 
  628.  
  629. kQAAlphaTest_None                EQU        0
  630. kQAAlphaTest_LT                    EQU        1
  631. kQAAlphaTest_EQ                    EQU        2
  632. kQAAlphaTest_LE                    EQU        3
  633. kQAAlphaTest_GT                    EQU        4
  634. kQAAlphaTest_NE                    EQU        5
  635. kQAAlphaTest_GE                    EQU        6
  636. kQAAlphaTest_True                EQU        7
  637.  
  638. ;  flags for QAAccess__xxx 
  639.  
  640. kQANoCopyNeeded                    EQU        $01
  641.  
  642. ; ************************************************************************************************
  643. ; *
  644. ; * Constants used as function parameters.
  645. ; *
  646. ; **********************************************************************************************
  647.  
  648. ; 
  649. ; * TQAVertexMode is a parameter to QADrawVGouraud() and QADrawVTexture() that specifies how
  650. ; * to interpret and draw the vertex array.
  651. ; 
  652.  
  653.  
  654. ; typedef long                            TQAVertexMode
  655. kQAVertexMode_Point                EQU        0                    ; Draw nVertices points 
  656. kQAVertexMode_Line                EQU        1                    ; Draw nVertices/2 line segments 
  657. kQAVertexMode_Polyline            EQU        2                    ; Draw nVertices-1 connected line segments 
  658. kQAVertexMode_Tri                EQU        3                    ; Draw nVertices/3 triangles 
  659. kQAVertexMode_Strip                EQU        4                    ; Draw nVertices-2 triangles as a strip 
  660. kQAVertexMode_Fan                EQU        5                    ; Draw nVertices-2 triangles as a fan from v0 
  661. kQAVertexMode_NumModes            EQU        6
  662. ; 
  663. ; * TQAGestaltSelector is a parameter to QAEngineGestalt(). It selects which gestalt
  664. ; * parameter will be copied into 'response'.
  665. ; 
  666.  
  667.  
  668. ; typedef long                            TQAGestaltSelector
  669. kQAGestalt_OptionalFeatures        EQU        0                    ; Mask of one or more kQAOptional_xxx 
  670. kQAGestalt_FastFeatures            EQU        1                    ; Mask of one or more kQAFast_xxx 
  671. kQAGestalt_VendorID                EQU        2                    ; Vendor ID 
  672. kQAGestalt_EngineID                EQU        3                    ; Engine ID 
  673. kQAGestalt_Revision                EQU        4                    ; Revision number of this engine 
  674. kQAGestalt_ASCIINameLength        EQU        5                    ; strlen (asciiName) 
  675. kQAGestalt_ASCIIName            EQU        6                    ; Causes strcpy (response, asciiName) 
  676. kQAGestalt_TextureMemory        EQU        7                    ; amount of texture RAM currently available 
  677. kQAGestalt_FastTextureMemory    EQU        8                    ; amount of texture RAM currently available 
  678. kQAGestalt_DrawContextPixelTypesAllowed EQU 9                ; returns all the draw context pixel types supported by the RAVE engine 
  679. kQAGestalt_DrawContextPixelTypesPreferred EQU 10            ; returns all the draw context pixel types that are preferred by the RAVE engine. 
  680. kQAGestalt_TexturePixelTypesAllowed EQU    11                    ; returns all the texture pixel types that are supported by the RAVE engine 
  681. kQAGestalt_TexturePixelTypesPreferred EQU 12                ; returns all the texture pixel types that are preferred by the RAVE engine.
  682. kQAGestalt_BitmapPixelTypesAllowed EQU    13                    ; returns all the bitmap pixel types that are supported by the RAVE engine. 
  683. kQAGestalt_BitmapPixelTypesPreferred EQU 14                    ; returns all the bitmap pixel types that are preferred by the RAVE engine. 
  684. kQAGestalt_OptionalFeatures2    EQU        15                    ; Mask of one or more kQAOptional2_xxx 
  685. kQAGestalt_MultiTextureMax        EQU        16                    ; max number of multi textures supported by this engine 
  686. kQAGestalt_NumSelectors            EQU        17
  687. kQAGestalt_EngineSpecific_Minimum EQU    1000                ; all gestalts here and above are for engine specific purposes 
  688. ; 
  689. ; * TQAMethodSelector is a parameter to QASetNoticeMethod to select the notice method
  690. ; 
  691.  
  692.     IF RAVE_OBSOLETE THEN
  693.  
  694. ; typedef long                            TQAMethodSelector
  695. kQAMethod_RenderCompletion        EQU        0                    ; Called when rendering has completed and buffers swapped 
  696. kQAMethod_DisplayModeChanged    EQU        1                    ; Called when a display mode has changed 
  697. kQAMethod_ReloadTextures        EQU        2                    ; Called when texture memory has been invalidated 
  698. kQAMethod_BufferInitialize        EQU        3                    ; Called when a buffer needs to be initialized 
  699. kQAMethod_BufferComposite        EQU        4                    ; Called when rendering is finished and its safe to composite 
  700. kQAMethod_NumSelectors            EQU        5
  701.     ELSE
  702.  
  703. ; typedef long                            TQAMethodSelector
  704. kQAMethod_RenderCompletion        EQU        0                    ; Called when rendering has completed and buffers swapped 
  705. kQAMethod_DisplayModeChanged    EQU        1                    ; Called when a display mode has changed 
  706. kQAMethod_ReloadTextures        EQU        2                    ; Called when texture memory has been invalidated 
  707. kQAMethod_ImageBufferInitialize    EQU        3                    ; Called when a buffer needs to be initialized 
  708. kQAMethod_ImageBuffer2DComposite EQU    4                    ; Called when rendering is finished and its safe to composite 
  709. kQAMethod_NumSelectors            EQU        5
  710.     ENDIF    ; RAVE_OBSOLETE
  711. ; 
  712. ; * kQATriFlags_xxx are ORed together to generate the 'flags' parameter
  713. ; * to QADrawTriGouraud() and QADrawTriTexture().
  714. ; 
  715.  
  716.  
  717. kQATriFlags_None                EQU        0                    ; No flags (triangle is front-facing or don't care) 
  718. kQATriFlags_Backfacing            EQU        $01                    ; Triangle is back-facing 
  719. ; 
  720. ; * kQATexture_xxx are ORed together to generate the 'flags' parameter to QATextureNew().
  721. ; 
  722.  
  723.  
  724. kQATexture_None                    EQU        0                    ; No flags 
  725. kQATexture_Lock                    EQU        $01                    ; Don't swap this texture out 
  726. kQATexture_Mipmap                EQU        $02                    ; This texture is mipmapped 
  727. kQATexture_NoCompression        EQU        $04                    ; Do not compress this texture 
  728. kQATexture_HighCompression        EQU        $08                    ; Compress texture, even if it takes a while 
  729. kQATexture_NonRelocatable        EQU        $10                    ; Image buffer in VRAM should be non-relocatable 
  730. kQATexture_NoCopy                EQU        $20                    ; Don't copy image to VRAM when creating it 
  731. kQATexture_FlipOrigin            EQU        $40                    ; The image(s) is(are) in a bottom-up format. (The image(s) is(are) flipped vertically.) 
  732. kQATexture_PriorityBits            EQU        $F0000000            ; Texture priority: 4 upper bits for 16 levels of priority 
  733. ; 
  734. ; * kQABitmap_xxx are ORed together to generate the 'flags' parameter to QABitmapNew().
  735. ; 
  736.  
  737.  
  738. kQABitmap_None                    EQU        0                    ; No flags 
  739. kQABitmap_Lock                    EQU        $02                    ; Don't swap this bitmap out 
  740. kQABitmap_NoCompression            EQU        $04                    ; Do not compress this bitmap 
  741. kQABitmap_HighCompression        EQU        $08                    ; Compress bitmap, even if it takes a while 
  742. kQABitmap_NonRelocatable        EQU        $10                    ; Image buffer in VRAM should be non-relocatable 
  743. kQABitmap_NoCopy                EQU        $20                    ; Don't copy image to VRAM when creating it 
  744. kQABitmap_FlipOrigin            EQU        $40                    ; The image is in a bottom-up format. (The image is flipped vertically.) 
  745. kQABitmap_PriorityBits            EQU        $F0000000            ; Bitmap priority: 4 upper bits for 16 levels of priority 
  746. ; 
  747. ; * kQAContext_xxx are ORed together to generate the 'flags' parameter for QADrawContextNew().
  748. ; 
  749.  
  750.  
  751. kQAContext_None                    EQU        0                    ; No flags 
  752. kQAContext_NoZBuffer            EQU        $01                    ; No hidden surface removal 
  753. kQAContext_DeepZ                EQU        $02                    ; Hidden surface precision >= 24 bits 
  754. kQAContext_DoubleBuffer            EQU        $04                    ; Double buffered window 
  755. kQAContext_Cache                EQU        $08                    ; This is a cache context 
  756. kQAContext_NoDither                EQU        $10                    ; No dithering, straight color banding 
  757. kQAContext_Scale                EQU        $20                    ; The draw context is to be scaled.  The front buffer is a different size than the back buffer. 
  758. kQAContext_NonRelocatable        EQU        $40                    ; The back buffer and the z buffer must not move in memory 
  759. kQAContext_EngineSpecific1        EQU        $10000000            ; engine specific flag # 1 
  760. kQAContext_EngineSpecific2        EQU        $20000000            ; engine specific flag # 2 
  761. kQAContext_EngineSpecific3        EQU        $40000000            ; engine specific flag # 3 
  762. kQAContext_EngineSpecific4        EQU        $80000000            ; engine specific flag # 4 
  763. ; 
  764. ; * kQAOptional_xxx are ORed together to generate the kQAGestalt_OptionalFeatures response
  765. ; * from QAEngineGestalt().
  766. ; 
  767.  
  768.  
  769. kQAOptional_None                EQU        0                    ; No optional features 
  770. kQAOptional_DeepZ                EQU        $01                    ; Hidden surface precision >= 24 bits 
  771. kQAOptional_Texture                EQU        $02                    ; Texture mapping 
  772. kQAOptional_TextureHQ            EQU        $04                    ; High quality texture (tri-linear mip or better) 
  773. kQAOptional_TextureColor        EQU        $08                    ; Full color modulation and highlight of textures 
  774. kQAOptional_Blend                EQU        $10                    ; Transparency blending of RGB 
  775. kQAOptional_BlendAlpha            EQU        $20                    ; Transparency blending includes alpha channel 
  776. kQAOptional_Antialias            EQU        $40                    ; Antialiased rendering 
  777. kQAOptional_ZSorted                EQU        $80                    ; Z sorted rendering (for transparency, etc.) 
  778. kQAOptional_PerspectiveZ        EQU        $0100                ; Hidden surface removal using InvW instead of Z 
  779. kQAOptional_OpenGL                EQU        $0200                ; Extended rasterization features for OpenGL™ 
  780. kQAOptional_NoClear                EQU        $0400                ; This drawing engine doesn't clear before drawing 
  781. kQAOptional_CSG                    EQU        $0800                ; kQATag_CSGxxx are implemented 
  782. kQAOptional_BoundToDevice        EQU        $1000                ; This engine is tightly bound to GDevice 
  783. kQAOptional_CL4                    EQU        $2000                ; This engine suports kQAPixel_CL4 
  784. kQAOptional_CL8                    EQU        $4000                ; This engine suports kQAPixel_CL8 
  785. kQAOptional_BufferComposite        EQU        $8000                ; This engine can composite with initial buffer contents 
  786. kQAOptional_NoDither            EQU        $00010000            ; This engine can draw with no dithering 
  787. kQAOptional_FogAlpha            EQU        $00020000            ; This engine suports alpha based fog 
  788. kQAOptional_FogDepth            EQU        $00040000            ; This engine suports depth based fog 
  789. kQAOptional_MultiTextures        EQU        $00080000            ; This bit set if engine supports texture compositing 
  790. kQAOptional_MipmapBias            EQU        $00100000            ; This bit is set if the engine supports mipmap selection bias 
  791. kQAOptional_ChannelMask            EQU        $00200000
  792. kQAOptional_ZBufferMask            EQU        $00400000
  793. kQAOptional_AlphaTest            EQU        $00800000            ; this engine supports alpha testing 
  794. kQAOptional_AccessTexture        EQU        $01000000            ; if engine supports access to texture 
  795. kQAOptional_AccessBitmap        EQU        $02000000            ; if engine supports access to bitmaps 
  796. kQAOptional_AccessDrawBuffer    EQU        $04000000            ; if engine supports access to draw buffer 
  797. kQAOptional_AccessZBuffer        EQU        $08000000            ; if engine supports access to zbuffer 
  798. kQAOptional_ClearDrawBuffer        EQU        $10000000            ; if engine supports QAClearDrawBuffer() 
  799. kQAOptional_ClearZBuffer        EQU        $20000000            ; if engine supports QAClearZBuffer() 
  800. kQAOptional_OffscreenDrawContexts EQU    $40000000            ; if engine supports TQADeviceOffscreen 
  801. ; 
  802. ; * kQAOptional2_xxx are ORed together to generate the kQAGestalt_OptionalFeatures2 response
  803. ; * from QAEngineGestalt().
  804. ; 
  805.  
  806.  
  807. kQAOptional2_None                EQU        0
  808. kQAOptional2_TextureDrawContexts EQU    $02                    ; if engine supports QATextureNewFromDrawContext() 
  809. kQAOptional2_BitmapDrawContexts    EQU        $04                    ; if engine supports QABitmapNewFromDrawContext() 
  810. kQAOptional2_Busy                EQU        $08                    ; if engine supports QABusy() 
  811. kQAOptional2_SwapBuffers        EQU        $10                    ; if engine supports QASwapBuffers() 
  812. kQAOptional2_Chromakey            EQU        $20                    ; if engine supports chromakeying via kQATag_Chromakey_xxx 
  813. kQAOptional2_NonRelocatable        EQU        $40                    ; if engine supports nonrelocatable texture & bitmap image buffers in VRAM 
  814. kQAOptional2_NoCopy                EQU        $80                    ; if engine supports ability to not copy texture & bitmap image to VRAM 
  815. kQAOptional2_PriorityBits        EQU        $0100                ; if engine supports texture & bitmap priority levels 
  816. kQAOptional2_FlipOrigin            EQU        $0200                ; if engine supports textures & bitmaps that are vertically flipped 
  817. kQAOptional2_BitmapScale        EQU        $0400                ; if engine supports scaled bitmap drawing 
  818. kQAOptional2_DrawContextScale    EQU        $0800                ; if engine supports scaled draw contexts 
  819. kQAOptional2_DrawContextNonRelocatable EQU $1000            ; if engine supports draw contexts with non relocatable buffers 
  820.  
  821. ; 
  822. ; * kQAFast_xxx are ORed together to generate the kQAGestalt_FastFeatures response
  823. ; * from QAEngineGestalt().
  824. ; 
  825.  
  826.  
  827. kQAFast_None                    EQU        0                    ; No accelerated features 
  828. kQAFast_Line                    EQU        $01                    ; Line drawing 
  829. kQAFast_Gouraud                    EQU        $02                    ; Gouraud shaded triangles 
  830. kQAFast_Texture                    EQU        $04                    ; Texture mapped triangles 
  831. kQAFast_TextureHQ                EQU        $08                    ; High quality texture (tri-linear mip or better) 
  832. kQAFast_Blend                    EQU        $10                    ; Transparency blending 
  833. kQAFast_Antialiasing            EQU        $20                    ; Antialiased rendering 
  834. kQAFast_ZSorted                    EQU        $40                    ; Z sorted rendering of non-opaque objects 
  835. kQAFast_CL4                        EQU        $80                    ; This engine accelerates kQAPixel_CL4 
  836. kQAFast_CL8                        EQU        $0100                ; This engine accelerates kQAPixel_CL8 
  837. kQAFast_FogAlpha                EQU        $0200                ; This engine accelerates alpha based fog 
  838. kQAFast_FogDepth                EQU        $0400                ; This engine accelerates depth based fog 
  839. kQAFast_MultiTextures            EQU        $0800                ; This engine accelerates texture compositing 
  840. kQAFast_BitmapScale                EQU        $1000                ; This engine accelerates scaled bitmap drawing 
  841. kQAFast_DrawContextScale        EQU        $2000                ; This engine accelerates scaled draw contexts 
  842.  
  843.  
  844.  
  845.  
  846.  
  847. ; ********************************************************************
  848. ; * TQAVersion sets the TQADrawContext 'version' field. It is set by
  849. ; * the manager to indicate the version of the TQADrawContext structure.
  850. ; ******************************************************************
  851.  
  852.  
  853. ; typedef long                            TQAVersion
  854. kQAVersion_Prerelease            EQU        0
  855. kQAVersion_1_0                    EQU        1
  856. kQAVersion_1_0_5                EQU        2                    ; Added tri mesh functions, color tables 
  857. kQAVersion_1_5                    EQU        3                    ; Added call backs, texture compression, and new error return code 
  858. kQAVersion_1_6                    EQU        4                    ; Added QAAccess_xxx, fog, _Options2, Clear_xxx, etc. 
  859.  
  860.  
  861. ; ***********************************************************************
  862. ; * TQADrawContext structure holds method pointers.
  863. ; * This is a forward refrence. The structure is defined later.
  864. ; *********************************************************************
  865.  
  866.  
  867.  
  868. ; ************************************************************************************************
  869. ; *
  870. ; * Typedefs of draw method functions provided by the drawing engine. One function pointer
  871. ; * for each of these function types in stored in the TQADrawContext public data structure.
  872. ; *
  873. ; * These functions should be accessed through the QA<function>(context,...) macros,
  874. ; * defined above.
  875. ; *
  876. ; **********************************************************************************************
  877.  
  878. TQANoticeMethod            RECORD 0
  879. standardNoticeMethod     ds.l    1                ; offset: $0 (0)        ;  Used for non-buffer related methods 
  880.                          ORG 0
  881. bufferNoticeMethod         ds.l    1                ; offset: $0 (0)        ;  Used for buffer handling methods 
  882. sizeof                     EQU *                    ; size:   $4 (4)
  883.                         ENDR
  884. ; ************************************************************************************************
  885. ; *
  886. ; * Public TQADrawContext structure. This contains function pointers for the chosen
  887. ; * drawing engine.
  888. ; *
  889. ; **********************************************************************************************
  890.  
  891. TQADrawContext            RECORD 0
  892. drawPrivate                 ds.l    1                ; offset: $0 (0)        ;  Engine's private data for this context 
  893. version                     ds.l    1                ; offset: $4 (4)        ;  Version number 
  894. setFloat                 ds.l    1                ; offset: $8 (8)        ;  Method: Set a float state variable 
  895. setInt                     ds.l    1                ; offset: $C (12)        ;  Method: Set an unsigned long state variable 
  896. setPtr                     ds.l    1                ; offset: $10 (16)        ;  Method: Set an unsigned long state variable 
  897. getFloat                 ds.l    1                ; offset: $14 (20)        ;  Method: Get a float state variable 
  898. getInt                     ds.l    1                ; offset: $18 (24)        ;  Method: Get an unsigned long state variable 
  899. getPtr                     ds.l    1                ; offset: $1C (28)        ;  Method: Get an pointer state variable 
  900. drawPoint                 ds.l    1                ; offset: $20 (32)        ;  Method: Draw a point 
  901. drawLine                 ds.l    1                ; offset: $24 (36)        ;  Method: Draw a line 
  902. drawTriGouraud             ds.l    1                ; offset: $28 (40)        ;  Method: Draw a Gouraud shaded triangle 
  903. drawTriTexture             ds.l    1                ; offset: $2C (44)        ;  Method: Draw a texture mapped triangle 
  904. drawVGouraud             ds.l    1                ; offset: $30 (48)        ;  Method: Draw Gouraud vertices 
  905. drawVTexture             ds.l    1                ; offset: $34 (52)        ;  Method: Draw texture vertices 
  906. drawBitmap                 ds.l    1                ; offset: $38 (56)        ;  Method: Draw a bitmap 
  907. renderStart                 ds.l    1                ; offset: $3C (60)        ;  Method: Initialize for rendering 
  908. renderEnd                 ds.l    1                ; offset: $40 (64)        ;  Method: Complete rendering and display 
  909. renderAbort                 ds.l    1                ; offset: $44 (68)        ;  Method: Abort any outstanding rendering (blocking) 
  910. flush                     ds.l    1                ; offset: $48 (72)        ;  Method: Start render of any queued commands (non-blocking) 
  911. sync                     ds.l    1                ; offset: $4C (76)        ;  Method: Wait for completion of all rendering (blocking) 
  912. submitVerticesGouraud     ds.l    1                ; offset: $50 (80)        ;  Method: Submit Gouraud vertices for trimesh 
  913. submitVerticesTexture     ds.l    1                ; offset: $54 (84)        ;  Method: Submit Texture vertices for trimesh 
  914. drawTriMeshGouraud         ds.l    1                ; offset: $58 (88)        ;  Method: Draw a Gouraud triangle mesh 
  915. drawTriMeshTexture         ds.l    1                ; offset: $5C (92)        ;  Method: Draw a Texture triangle mesh 
  916. setNoticeMethod             ds.l    1                ; offset: $60 (96)        ;  Method: Set a notice method 
  917. getNoticeMethod             ds.l    1                ; offset: $64 (100)        ;  Method: Get a notice method 
  918. submitMultiTextureParams  ds.l    1                ; offset: $68 (104)        ;  Method: Submit Secondary texture params 
  919. accessDrawBuffer         ds.l    1                ; offset: $6C (108)
  920. accessDrawBufferEnd         ds.l    1                ; offset: $70 (112)
  921. accessZBuffer             ds.l    1                ; offset: $74 (116)
  922. accessZBufferEnd         ds.l    1                ; offset: $78 (120)
  923. clearDrawBuffer             ds.l    1                ; offset: $7C (124)
  924. clearZBuffer             ds.l    1                ; offset: $80 (128)
  925. textureFromContext         ds.l    1                ; offset: $84 (132)
  926. bitmapFromContext         ds.l    1                ; offset: $88 (136)
  927. busy                     ds.l    1                ; offset: $8C (140)
  928. swapBuffers                 ds.l    1                ; offset: $90 (144)
  929. sizeof                     EQU *                    ; size:   $94 (148)
  930.                         ENDR
  931. ; ************************************************************************************************
  932. ; *
  933. ; * Acceleration manager function prototypes.
  934. ; *
  935. ; **********************************************************************************************
  936.  
  937. ;
  938. ; extern TQAError QADrawContextNew(const TQADevice *device, const TQARect *rect, const TQAClip *clip, const TQAEngine *engine, unsigned long flags, TQADrawContext **newDrawContext)
  939. ;
  940.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  941.         IMPORT_CFM_FUNCTION QADrawContextNew
  942.     ENDIF
  943.  
  944. ;
  945. ; extern void QADrawContextDelete(TQADrawContext *drawContext)
  946. ;
  947.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  948.         IMPORT_CFM_FUNCTION QADrawContextDelete
  949.     ENDIF
  950.  
  951. ;
  952. ; extern TQAError QAColorTableNew(const TQAEngine *engine, TQAColorTableType tableType, void *pixelData, long transparentIndexFlag, TQAColorTable **newTable)
  953. ;
  954.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  955.         IMPORT_CFM_FUNCTION QAColorTableNew
  956.     ENDIF
  957.  
  958. ;
  959. ; extern void QAColorTableDelete(const TQAEngine *engine, TQAColorTable *colorTable)
  960. ;
  961.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  962.         IMPORT_CFM_FUNCTION QAColorTableDelete
  963.     ENDIF
  964.  
  965. ;
  966. ; extern TQAError QATextureNew(const TQAEngine *engine, unsigned long flags, TQAImagePixelType pixelType, const TQAImage images[], TQATexture **newTexture)
  967. ;
  968.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  969.         IMPORT_CFM_FUNCTION QATextureNew
  970.     ENDIF
  971.  
  972. ;
  973. ; extern TQAError QATextureDetach(const TQAEngine *engine, TQATexture *texture)
  974. ;
  975.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  976.         IMPORT_CFM_FUNCTION QATextureDetach
  977.     ENDIF
  978.  
  979. ;
  980. ; extern void QATextureDelete(const TQAEngine *engine, TQATexture *texture)
  981. ;
  982.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  983.         IMPORT_CFM_FUNCTION QATextureDelete
  984.     ENDIF
  985.  
  986. ;
  987. ; extern TQAError QATextureBindColorTable(const TQAEngine *engine, TQATexture *texture, TQAColorTable *colorTable)
  988. ;
  989.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  990.         IMPORT_CFM_FUNCTION QATextureBindColorTable
  991.     ENDIF
  992.  
  993. ;
  994. ; extern TQAError QABitmapNew(const TQAEngine *engine, unsigned long flags, TQAImagePixelType pixelType, const TQAImage *image, TQABitmap **newBitmap)
  995. ;
  996.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  997.         IMPORT_CFM_FUNCTION QABitmapNew
  998.     ENDIF
  999.  
  1000. ;
  1001. ; extern TQAError QABitmapDetach(const TQAEngine *engine, TQABitmap *bitmap)
  1002. ;
  1003.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1004.         IMPORT_CFM_FUNCTION QABitmapDetach
  1005.     ENDIF
  1006.  
  1007. ;
  1008. ; extern void QABitmapDelete(const TQAEngine *engine, TQABitmap *bitmap)
  1009. ;
  1010.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1011.         IMPORT_CFM_FUNCTION QABitmapDelete
  1012.     ENDIF
  1013.  
  1014. ;
  1015. ; extern TQAError QABitmapBindColorTable(const TQAEngine *engine, TQABitmap *bitmap, TQAColorTable *colorTable)
  1016. ;
  1017.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1018.         IMPORT_CFM_FUNCTION QABitmapBindColorTable
  1019.     ENDIF
  1020.  
  1021. ;
  1022. ; extern TQAEngine *QADeviceGetFirstEngine(const TQADevice *device)
  1023. ;
  1024.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1025.         IMPORT_CFM_FUNCTION QADeviceGetFirstEngine
  1026.     ENDIF
  1027.  
  1028. ;
  1029. ; extern TQAEngine *QADeviceGetNextEngine(const TQADevice *device, const TQAEngine *currentEngine)
  1030. ;
  1031.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1032.         IMPORT_CFM_FUNCTION QADeviceGetNextEngine
  1033.     ENDIF
  1034.  
  1035. ;
  1036. ; extern TQAError QAEngineCheckDevice(const TQAEngine *engine, const TQADevice *device)
  1037. ;
  1038.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1039.         IMPORT_CFM_FUNCTION QAEngineCheckDevice
  1040.     ENDIF
  1041.  
  1042. ;
  1043. ; extern TQAError QAEngineGestalt(const TQAEngine *engine, TQAGestaltSelector selector, void *response)
  1044. ;
  1045.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1046.         IMPORT_CFM_FUNCTION QAEngineGestalt
  1047.     ENDIF
  1048.  
  1049. ;
  1050. ; extern TQAError QAEngineEnable(long vendorID, long engineID)
  1051. ;
  1052.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1053.         IMPORT_CFM_FUNCTION QAEngineEnable
  1054.     ENDIF
  1055.  
  1056. ;
  1057. ; extern TQAError QAEngineDisable(long vendorID, long engineID)
  1058. ;
  1059.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1060.         IMPORT_CFM_FUNCTION QAEngineDisable
  1061.     ENDIF
  1062.  
  1063.  
  1064. ;
  1065. ; extern TQAError QAAccessTexture(const TQAEngine *engine, TQATexture *texture, long mipmapLevel, long flags, TQAPixelBuffer *buffer)
  1066. ;
  1067.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1068.         IMPORT_CFM_FUNCTION QAAccessTexture
  1069.     ENDIF
  1070.  
  1071. ;
  1072. ; extern TQAError QAAccessTextureEnd(const TQAEngine *engine, TQATexture *texture, const TQARect *dirtyRect)
  1073. ;
  1074.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1075.         IMPORT_CFM_FUNCTION QAAccessTextureEnd
  1076.     ENDIF
  1077.  
  1078. ;
  1079. ; extern TQAError QAAccessBitmap(const TQAEngine *engine, TQABitmap *bitmap, long flags, TQAPixelBuffer *buffer)
  1080. ;
  1081.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1082.         IMPORT_CFM_FUNCTION QAAccessBitmap
  1083.     ENDIF
  1084.  
  1085. ;
  1086. ; extern TQAError QAAccessBitmapEnd(const TQAEngine *engine, TQABitmap *bitmap, const TQARect *dirtyRect)
  1087. ;
  1088.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1089.         IMPORT_CFM_FUNCTION QAAccessBitmapEnd
  1090.     ENDIF
  1091.  
  1092.  
  1093.  
  1094.  
  1095.     IF TARGET_OS_MAC THEN
  1096. ;
  1097. ; extern TQAError QARegisterDrawNotificationProc(Rect *globalRect, TQADrawNotificationProcPtr proc, long refCon, TQADrawNotificationProcRefNum *refNum)
  1098. ;
  1099.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1100.         IMPORT_CFM_FUNCTION QARegisterDrawNotificationProc
  1101.     ENDIF
  1102.  
  1103. ;
  1104. ; extern TQAError QAUnregisterDrawNotificationProc(TQADrawNotificationProcRefNum refNum)
  1105. ;
  1106.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1107.         IMPORT_CFM_FUNCTION QAUnregisterDrawNotificationProc
  1108.     ENDIF
  1109.  
  1110.     ENDIF    ; TARGET_OS_MAC
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.     ENDIF ; __RAVE__ 
  1118.  
  1119.